v3.1.3

Compare Source

What's Changed

• Add comments and docstrings to several API endpoint schemas by @​ksinder in #​573
• fix(types): Support browser fetch and remove node-fetch types by @​dvanoni in #​574

Full Changelog: makenotion/notion-sdk-js@0e38438...v3.1.3

View this version on NPM: https://www.npmjs.com/package/@​notionhq/client/v/3.1.3

v3.1.2

Compare Source

What's Changed

• Add max_file_upload_size_in_bytes field to User response by @​ksinder in #​570

Full Changelog: makenotion/notion-sdk-js@194f06d...v3.1.2

View this version on NPM: https://www.npmjs.com/package/@​notionhq/client/v/3.1.2

v3.1.1

Compare Source

What's Changed

• Updates node/nvm version required by @​typeoneerror in #​568

New Contributors

• @​typeoneerror made their first contribution in #​568

Full Changelog: makenotion/notion-sdk-js@f8bb1d0...v3.1.1

View this version on NPM: https://www.npmjs.com/package/@​notionhq/client/v/3.1.1

v3.1.0

Compare Source

What's Changed

• Add support for File Upload API endpoints by @​ksinder in #​565
  • Sync the latest OpenAPI schema for Notion's Public API to src/api-endpoints.ts
  • Introduce the /v1/file_uploads family of API endpoints (File Upload Create, Get, List, Send, Complete)
    • notion.fileUploads.send builds a FormData object to send fields via multipart/form-data
  • Add several refactors to extract common reused schema components, which drastically reduces the size of the file
• Add file upload API example and fix Blob send logic by @​ksinder in #​566
  • Fix the FormData parameter passing logic in src/Client.ts for the Send File Upload API
  • Add examples/intro-to-notion-api/intermediate/5-upload-file.js example of using the File Upload API to upload and attach a file

Full Changelog: makenotion/notion-sdk-js@f2e1665...v3.1.0

View this version on NPM: https://www.npmjs.com/package/@​notionhq/client/v/3.1.0

v3.0.1

Compare Source

What's Changed

• Support width_ratio parameter and field on column Blocks by @​ksinder in #​561
• Export several common api-endpoints types from src/index.ts by @​ksinder in #​562

Full Changelog: makenotion/notion-sdk-js@8b867fd...v3.0.1

View this version on NPM: https://www.npmjs.com/package/@​notionhq/client/v/3.0.1

v3.0.0

Compare Source

What's Changed

This update, v2.3.0 → v3.0.0, is marked as a major version upgrade due to the Node minimum version increase to 18, as part of the change to use built-in fetch as the default in the Client constructor instead of node-fetch.

• Sync OpenAPI schema as of 2025-04-08 to src/api-endpoints.ts by @​ksinder in #​558
  • Refactor common parameter shapes into new types: InternalFileRequest, ExternalFileRequest, and InternalOrExternalFileWithNameRequest
  • Support commenting on a non-page block in the Create Comment API by accepting a parent type of block_id
• Use isomorphic fetch by @​sv2dev in #​506
  • This updates the minimum Node engine version from 12 to 18.
• Small typo fixes in docs and example files
  • docs: fix incorrect example path in README by @​R-jisu in #​556
  • Update .env.example by @​jtsmith1287 in #​532
  • Update README.md with correct cd command by @​crosskayla in #​493

Full Changelog: makenotion/notion-sdk-js@650d23b...v3.0.0

View this version on NPM: https://www.npmjs.com/package/@​notionhq/client/v/3.0.0

New Contributors

• @​sv2dev made their first contribution in #​506
• @​R-jisu made their first contribution in #​556
• @​jtsmith1287 made their first contribution in #​532
• @​crosskayla made their first contribution in #​493